id: user-atc-session title: Get User ATC Session meta: Overview of the User ATC Session endpoint of the Infinite Flight Live API order: 17 contributor: sqeezelemon #
Get User ATC Session #
Retrieves an ATC session from the log of a given user.
Resource #
GET https://api.infiniteflight.com/public/v2/users/{userId}/atc/{atcSessionId}
Authorization #
Include your API key (<apikey>) by either:
- Adding the
apikeyquery parameter. For example,?apikey=<apikey>. - Sending a bearer authorization header with your API key. For example,
Authorization: Bearer <apikey>.
Parameters #
| Name | Located in | Description | Required | Schema |
|---|---|---|---|---|
userId |
path | ID of the User | Yes | string (uuid) |
atcSessionId |
path | ID of the ATC Session | Yes | string (uuid) |
Response #
Sample Response #
{
"errorCode": 0,
"result": {
"id": "857b1686-455d-481a-8bdf-c46cd7711691",
"atcSessionGroupId": "1fcff4cb-48e6-46dc-8c87-4202bcdd7cc0",
"facility": {
"id": "4fda33c2-91b9-1a57-98f2-a765abd4c019",
"airportIcao": "VRMM",
"latitude": 4.191753387451172,
"longitude": 73.52915954589844,
"frequencyType": 4
},
"created": "2020-07-03T10:27:08.021137",
"updated": "2020-07-03T10:37:49.026714",
"operations": 9,
"totalTime": 86.15142588333333
}
}
LiveAPIResponse #
Response Type: application/json
| Name | Type | Description |
|---|---|---|
errorCode |
integer | Enum: "Ok = 0", "UserNotFound = 1", "MissingRequestParameters = 2", "EndpointError = 3", "NotAuthorized = 4", "ServerNotFound = 5", "FlightNotFound = 6", "NoAtisAvailable = 7" |
result |
UserAtcSession | An ATC session from the logbook. |
UserAtcSession #
| Name | Type | Description |
|---|---|---|
id |
string (uuid) | The ID of the session |
atcSessionGroupId |
string (uuid) | Identifies a group of sessions (for when a controller opens multiple frequencies at the same airport) |
facility |
ATCFacility | Details of the facility that was opened |
created |
string (datetime) | The time at which the frequency was first opened |
updated |
string (datetime) | The time at which last report was received |
operations |
integer | The number of operations earned during the session |
totalTime |
double | The duration of the session in minutes |
ATCFacility #
| Name | Type | Description |
|---|---|---|
id |
string (uuid) | ID of the ATC Facility |
airportIcao |
string | The ICAO of the airport at which the facility is located |
latitude |
double | Latitude of the ATC Facility |
longitude |
double | Longitude of the ATC Facility |
frequencyType |
ATCEntityType | Type of ATC Facility. Enum: "Ground = 0", "Tower = 1", "Unicom = 2", "Clearance = 3", "Approach = 4", "Departure = 5", "Center = 6", "ATIS = 7", "Aircraft = 8", "Recorded = 9", "Unknown = 10", "Unused = 11" |